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Shift away from superstition 

It's easy to get as superstitious as a baseball player around 

computers. You may notice, for example, that disks boot better if you scratch 
\our nose with the tip of your elbow before typing FR#6. Some of these 
superstitions may have an electrical basis, but here's one that doesn't— 1 
read in a user group letter this month that AppleWorks printer setup strings 
seem to work better if you enter them by holding the shift key down rather 
than by using CAPS LOCK. Lets stamp this out before it gets serious. On an 
.^ppic II there is absolutely no difference between a character entered using 
the shift key and the same character entered using CAPS LOCK. From inside 
the machine you can't tell the two apart even if you want to. (It IS important 
however, to enter most printer setup strings using capital, rather than lower 
case, letters.) 

ProDOS directoiy sorters bave become popular in the general 
computer press. Byte published one in its June issue (page 117) that 
contains the same old bug most ProDOS directoiy sorters have. Don't use it 
For more information see the March 1986 Open-Apple, page 210. Then tell 
us why a magazine like Byte, which almost never mentions the Apple 11 to 
begin with, is writing about ProDOS directoiy sorters when tiiere are so many 
more important Apple II technical loose ends to tie up. Computefs Juty 
sorter (page 96) doesn't have the usual bug, but only because it doesn't save 
the sorted directory back on the disk. It just prints it out to your choice of 
saeen or printer. This and game reviews were Computers tc^ contribution 
to thei^ple II literature in July 

Apple's ^plefiwks maiteters are looking for intei^e^its^CMles 
about how real people use AppleWorks. Since G^pen'^ppie^s readers are by 
and large real they asked me to ask you to bang out a couple of paragraphs 
on how you use AppleVlforks mid send them to Daniel Paul, Mail Stop 3-P, 
,Apple Computer Inc, 20525 Marian! Ave, Cupertino, CA 95014 by July 15. 

Uncle DOS recently received a letter headlined TOP SECRET and 
signed by a character named Sore Throat The letter divulged that Apple's 
Software Licensing department has a package available cdled the ^ple II 
niecard Tool Kit 

Licensing department documents navly obtained by Opeu'Apple describe 
the package as "four software modules for the 'filecard' (AppleWorks) 
interface. The 'User Input Routine' object module implements recommended 
.\pple keyboard input for Pascal Applesoft, and assembly language 
programs. The "Console Driver' object module offers fast efficient 80- 
column text output and saeen control for Pascal, Applesoft and assembly 
language i»rograms. A Pascal object 'Console Stuff unit ofiers text formatting 
aids, ^ well as utilities for overiaying message boxes and Help saeens. A 
Pascal source Tllecard' unit provkles uHlities for implementing the filecard 
interface. Demo source files are ^ inclided" 

I can find no evidence that Apple has ever mentioned the existence of this 
tool kit in any of its developer publications. I wish someone would explain to 
me why Apple seems so dedicated to trashing the filecard interface in favor 
of the mouse desktop, which is more complicated for both users and 
programmers. There are more copies of AppleWorks being used today than 
there are copies of the Macintosh itself. The filecard interface is intuitive, 
understood by people all over the worid (even computer salespeople), and 
requires only two hands, nonetheless, during the last two years I have never 
seen or heard Apple encourage anyone to use it with one exception. The 
mouse desktop, on ttie other hand, is shrilly promoted vdierever Apple 
gatiiers developers. 

The one exception is ui Apple // Hmmn interface Ouidellnes. This manual 



indudes a 14-page diapter on tiie filecard interface. The more complicated- 
mouse interliace requires a 55-page chapter. 

Apple's Software Licensing department collects fees from people who 
use Apple-created software in their own software packages. In exchange for 
paying the fees you get the right to include Apple's software in an unlimited 
number of copies of your own package. You also get free updates to the 
licensed software. With some items you get a copy of the licensed software, 
technical documentation not available elsewhere, or both. 

To get in touch with these people, call 408-973-4667 or write Software 
Licensing, Mail Stop 28-B, Apple Computer Inc, 10101 n DeAnza Blvd, 
Cupertino, CA 95014. Here is a complete list of the Apple II products 
airrently available for licensing. Items marked with vwll be provided ("*R" 
means provided by request only), items marked "U " are unsupported: 



DOS 3.3 

FID 

FPBflSIC/lNTBflSIC 
DOS TOOL KIT 

ProOOS/Basic.systeW 

FILER/CONVERT 
Basic. system source code 
ProODS disk formatter 
ProDDS USERS DISK 

(German) 

(FrBnch) 

(Italian) 
ProDOS BRCKUP II 

Filecard Tool Kit 
Desktop Tool Kit 
Printer Tool Kit 



$50 »R U 
$50 *R U 
$25 *R U 



%im 

$50 
$50 



$35 



$50 * 

m * 



6502 Std Apple Numeric^ (SRNC) 150 * 
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SuperPiiot 


f50 




SuperPilot Library 


J25 


* 


Pascal operating system 


$100 




ProDDS access unit 


$50 


♦ 


Volume manager unit 


$50 


» 


Pascal formatter 1.3 


$25 


* 


Pascal filer 1.3 


$50 




ftttach tools 1.3 


$50 




Pascal short graphics unit 


$25 




Pascal 1.2 4BK runtime pkg 


$50 


* 


Pascal 1.3 G4K or 12BK runtime: 


$50 


* 


Pascal 1.3 treesearch, idsearch 


$50 


* 



If you're wondering whether you have to be a "third-party developer" to 
license these packages, you'll be glad to hear that Apple seems to define 
"developer" as someone viho has licensed something from them. If you'd 
like a copy of the Filecard Tool Kit for example, call and ask for copies of 
Apple's Software License Agreement Be prepared to provide a business 
name— these folks know me as Tom Weishaar Productions, for example. 
They'll send you some long legal forms and "Exhibit B," which is a list of the 
packages available for licensing. Sign the forms, send them back with a 
check, and they'll send you disks and documentation. 

The most interesting stuff is the three tool kits, the SATiE package, and the 
Pascal collection. I'm not sure what's in the Filecard Tool Kit at the moment 
when I ordered it together witti the Desktop Tool Kit I got the Printer Tool Kit 
instead. (A quidi phone call and the right package is on the way) 

Meanwhile, 1 can tell you the Desktop Tool Kit consists of eight disks — four 
assembly language/Applesoft and four Pascal. TWo of each set of four disks 
includes routines for doing the mouse desktop on the 80-column text 
screen, the other two have routines for doing the mouse desktop on the 
double-high resolution graphics screen. In addition to the eight disks, you 
get photocopied versions of the following manuals: Apple U tiuman 
Interface Guidelines, Developefs Handbook for the Apple HMouseText Tool 
Kit Mouse Graphics Tbol Kit External Reference Specification, and J^ple II 
Graphics Primitives Handbook. This is an immense amount of material for 
$50, especially from the tightwads at Apple. 

The Printer Tool Kit consists of two ProDOS disks that are filled with 
assembly-language color-and-monochrome-graphics printer-drivers for the 
Apple Scribe, Imagewriter, and Imagewriter II printers. It includes a 
photocopied manual called the Developer's Handbook for the Apple II 
Printer Tool Kit The drivers support control of picture size and aspect ratio; 
RGB 8- and 16<x)lor, FITSC 8- and 16-color, and high-resolution and double- 
high-resolution monochrome graphics; screen pre-view and aopping; and 
page positioning and rotation. 

The SAME (Standard Apple Numerics Environment) package consists of 
three disks— one ProDOS and two Pascal— frill of assembly language 
routines and a printed copy of the Apple Humerics Manual SAME is one of 
the first widely-available products that conforms to a binary floating-point 
arithmetic standard called IEEE 754. It provides for four types of variables 
with 7, 15, 18, and 19 significant decimal digits. (Applesoft provides nine 
significant digits, Apple Pascal six.) 

none of the manuals listed here was included in Open-Z^ple's March list 
of technical documentation available from Apple (page 211). 

More technical support for anyone ii4io wants it (and can afford it) is 
available from Apple in the form of subscriptions to the ^ple II Technical 
notes. Open-ylppte published a list of the current tech notes in March (page 
211) and updated it last month (page 2.54). Apple is now selling subscriptions 
to the notes to anyone who's interested. A complete set of 1985's notes is 
$45 (all active notes were revised in 1985, so this is the equivalent of a 
complete set of back issues); a subscription to this year's notes, v^^ich are 
issued every other month, is $25. Subscriptions are available from the Apple 
Computer Mailing Facility, 467 Saratoga Ave, Suite 621 San Jose, CA 95129 
(408-988-6009). Also available, for a mere $75 each, are Inside Apple TMk 
and Inside LaserWriter. 

Apple's lawyers were stung by their first big defeat in Hay, when 
Australia's High Court ruled that prior to the amendment of the Australian 
Copyright Act in 1984, software in ROM was not eligible for copyright under 
Australian law, The court, which is the highest in Australia, overturned a 
decision of the frill Federal Court, v\^iich had upheld Apple's claim of 
copyright infringement against Computer Edge Pty Ltd, importer of the 
Taiwanese-made Wombat Apple ll-compatible into Australia. 

The eariier decision of the frill Federal Court, which put Computer Edge 
out of business, had itself overturned an original Federal Court decision in 
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this long legal battle, which Apple lost in December 1983. That dedsion led 
the Australian government to rewrite its Copyright Act in 1984. The new act 
gives all software, even that written before 1984, frill copyright protection. 

Thus Apple's loss is largely academic in Australia. It could be more 
significant in other Commonwealth countries, such as Canada and Hong 
Kong, however, that have not yet rewritten their copyright laws to specifically 
include software. Cases such as Australia's can be cited in courts throughout 
the Commonwealth when the underlying laws are similar. 

Meanvk^iile, in other legal action in May, Apple won a lower court copyri^t 
decision against Canadian importers of Apple ll-compatibles. In that case 
the importers conceded that source code can be copyrighted, but argued 
that ROM was not a suitable material for a literary work. The court decided 
that the wording of the copyright act was broad enough to include silicon 
chips. It isn't yet known v^at effect this case may have on an ongoing update 
to Canada's copyright law. 

Question: why do all these suits focus on whether software in general is 
copyrightable rather than on whether the Apple II Monitor in particular was 
placed in the public domain by Steve Wozniak prior to being copyrighted by 
Apple Inc? 



Picking Up 
Applesoft 




EjKr€ises in self-modification 

Back in March Uncle DOS got a question about how to capture a user's 
formula interactively on the ke)t)oard and enter it into a running program 
(page 216). Uncle didn't know how, but referred to four articles in CaH - 
APPLE, and inCiderthat explained how it could be done. 

In April Open-Apple carried a long article on breaking the 48K memory 
limit of Applesoft using a RAMdisk (page 217-2.21). This article went into 
great detail on the structure of Applesoft programs as they appear in 
memory. Among other things, it showed how to split Applesoft programs to 
avoid the graphic screens and how to overiay program segments. 

Then, in June, Open-Apple built upon the ^ril article by showing how to 
examine the value of all currently defined variables. The pro-am presented 
in that article, using April's information on the structure of an Applesoft 
program in memory, modified itself. It introduced a routine that could 
identify the memory location of any program line. Once that is accomplished, 
it is a fairly simple matter to POKE changes into the line. 

This monUi, we'll build upon the June article and answer March's question 
about getting a user's formula into a program. We'll also show how to hide 
short assembly language routines inside the body of an Applesoft program. 

Self-modifying ^plesoft. Let me begin by reminding you that data 
processing professionals abhor self-modifying code. Don't discuss \^atyou 
learn here in polite company or during any job interviews. 

In last month's article, I showed you a program that could make fixed- 
length changes to itself. For example, we had the line: 

37024 : PRINT N$;" = ";XX$ 

Our goal was to change tiie "XX$" to the actual name of the variable we 
wanted to print ~ ma)t>e "0Z%", for example, or "OZ " (with a space after the 
Z to denote a floating-point variable). This was easy because we always knew 
ahead of time exactly how many characters were involved. When you start 
letting people enter command strings on the keyboard, however, you don't 
know ahead of time how long the string will be. 

Somehow, we have to write a program line that can be modified later and 
that reserves the maximum amount of space well ever need. How about this 
one: 

Last time 1 counted there were 60 asterisks in that line, which ^es us a 60- 
byte command line to work with. If the user enters a 30-byte command, 
however, we also need a way to tell ^plesoft to ignore the extra asterisks at 
the end of the line. Vie can do this by adding a colon and a REM to the end of 
the user's command. For example, if the user wants to insert the formula FOR 
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X=0 TO 30 : Y=1000 * 108 then line 370. after modification, shouM look 
something like this: 

370 FDR X=0 TD 30 : Y=1000 * 1.0b\ : R£n»«»»*«»»*»»***»*«*«»«»«*«*« 

now all we have to do is find the location of line 370 in memory. Here's the 
routine we used last month to do this. You call this routine after putting the 
number of the line you want to find in L It returns the address of that line in 
ACL Line 100 was numbered 37700 last month; 1 had to move it to the 
beginning of the program to get everything to work: 

100 DEF FN PK(flDR)=PE:EK(flDR)+PEEK(flDR+l)»2SG 

37990 REM * Find line number L * 

37991 REM * flCL=addrBss of current line * 

37992 REM * flNL=address of next line * 

37993 REM set flCL to start of program (TXTTflB) 

37994 RCL=FN PK2(103) : REM address of current line 

37995 flNL=FN PK2(flCL) : REM address of next line 

3799G REM find line number L 

37997 IF L=FN PK2(flCL+2) THEN RETURN 

37998 V=FN PK2(flNL) : IF V>0 THEN flCL=ftNL : ftNL=V : GOTO 37997 

37999 PRINT "There's no line ^L;' in this program." : STOP 

Unfortunately simply collecting a command string with an IliPUT statement 
and POKEing it into line 370 doesn't work. The reason it doesn't work is that 
Applesoft expects command words such as PRini and IF to appear as 
tokens, as discussed in April (page 218). 

When I found this out I read the four articles Unde DOS recommended in 
March to see how ttiose authors had solved the token problem. The most 
helpful article, as is often the case, was the one by Cornelius Bongers. 
Bongers identifies the routine inside ^plcsoft that converts program lines 
typed on the keyboard into tokens. After reading the four artides, I decided 
the best way to proceed was to use a smidgen of assembly language. 

The ^plesoft tokenization routine is at $D56C Under normal conditions, 
it converts tiie ASCII contents of the keyboard input buffer ($200-2JT) into a 
tokenized program line. The converted line is never longer tiian the original, 
so tiie converted line is stored right over tiie top of the original in the buffer. 
The routine expects the address of the keyboard buffer to be stored at byte 
$B8-$B9 (184-185) and requires a couple of otiier bytes to be initialized. The 
following routine, which we'll call PARSE, saves and restores the contents of 
$B8-$B9, does tiie other required initialization, and executes $0560 



aE4 


fiS B8 


LDA $88 




BEG 


46 


PHfl 


save bsE-eight and -nine on stack 


8E7 


AS B9 


LDfl $09 




8E9 


48 


PHR 




BEfi 


fi2 01 


LOX 81 


avoid having a zero in the prografn 


BEC 


CR 


DEX 


make a zero 


BED 


B£ 86 


STX $Ba 


store at bee-eight 


6EF 


CA 


OEX 


make it $FF for PARSE 


8F0 


fl0 02 


LDY B2 




BF2 


84 89 


STY $B9 


$88 nou points at keyboard buffer at $0200 


8F4 


84 13 


STY $13 


initialize data flag 


BFG 


R0 04 


LDY 84 


initialize Y 


BFB 


20 GC 05 


J5R $D5GC 


execute PARSE 


BFB 


68 


PLfl 




BFC 


B5 89 


STft $89 


restore adr at bee-eight to previous value 


BFE 


SB 


PLfl 




BFF 


85 88 


5TR $BB 




901 


60 


RTS 





Assume we have this routine in memory and have told the variable PARSE 
its address. We can now have tiie user enter a desired formula using iPiPUT 
and convert it to tokens like this: 

300 L=370 : GQSUB 37990 : ADR=ACL+4 : REM find line that will be modified 
310 INPUT "ENTER APPLESOFT CMD: CMO$ 
320 CALL PARSE 

ADR points to the colon in line 370. The colon is four bytes beyond tiie 
beginning of the program line (two bytes for tiie next-line pointer, two bytes 
for the line number), thus tiie ADR=ACL+4 in line 300. Mow lefs move the 
tokenized line from tiie keyboard input buffer into line 370: 

325 ROQM=60 : REM this is the number of asterisks in line 370 

330 FOR 1=0 TO RQOM-1 

335 : V=PEEK(512+I) : 11=1 

340 : IF V=0 THEN I=ROOM : GOTO 350 

345 : POKE AOR+I,V 

350 NEXT 
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PARSE will leave a zero at the end of the tokenized line. Line 540 looks for 
this zero and gets us out of tiie loop when it finds it If a user enters a 
command tiiat takes up more tiian 60 bytes, we need to print an error 
message: 

355 IF V< >0 THEN PRINT TDRMULA TOD LDNG" : PRINT : GOTO 310 

And don't forget that we always need to add ":REM" at the end of the user's 
command: 

3G0 POKE flDR+11,58 : POKE flDR+U+1,178 : REM ":REM'' 

A hidden beauty of this trick is that tiie user can include commas and 
colons in the formula, even though INPUT won't accept them and will print an 
EXTRA IQnORED message. The reason for tiiis is tiiat eveiytiiing tiie user 
types goes into the keyboard buffer, whether Applesoft ignores it or not 
notice that we never actually do anytiiing with ttie CMD$ tiiat we collect with 
inPUT in line 310. Instead, we let PARSE work directiy on tiie contents of ttie 
keyboard buffer. 

WhatiftJie user types a command line tiiat hasa SYPiTAXERROR? Lefs trap 
it and let tiie user re-enter the line: 

3S5 DNERR GOTO 400 : REM syntax error trap 

370 :REM************************************************************ 
380 POKE 216,0 : PRINT : GOTO 310 : REM clear onerr, restart 

400 IF PEEK(222) < > IG THEN PRINT "ERROR a'';PEEK(222) ; 

" IN LINE '';PEEK(218) + PEEK(219)*25G : END 
410 PRINT "THIS CMD HAS A SYNTAX ERROR." 

420 CALL -3288 : GOTO 380 : REM clear stack- -see Jan 85, page 2 

Line 380 sends us back to line 310 for another command. Let's use CMD$ 
after all to give tiie user tiie option to quit by entering an empty line. And 
when tiie user quits, let's have our littie demo program list the formula we've 
placed in line 370, as well as some otiier stuff we're going to put in line 230: 

315 IF LEN(CMD$)=0 THEN LIST 230: LIST m : END 

Embedding machine code in Applesoft REMs. To finish our littie 
program, we have to figure out some way to get our PARSE routine into 
memory In tiie past, Open-J^ple has always tucked such routines into the 
free memory in page tiiree. Because tiiis area is used for so many different 
purposes, however, you virtually have to reload code there every time you 
want to use it You can't depend on a piece of code still being tiiere from tiie 
last time you used it 

This is no good. One way around the problem is to actually store your 
machine language code in REM statements. If you do this, you definitely 
don't want Applesoft to attempt to execute the program line, so leave a REN 
at the beginning to make Applesoft ignore it Use exactiy as many asterisks 
as there are bytes in your assembly language routine: 

200 L=230 : GOSUB 37990 : PARSC=ACL+6 : REfl find line that uili fae modified 
230 :REM****************************** 

This time we want line 200 to point at the first asterisk in line 230, rather 
tiian at tiie colon as we did witii line 370. Thus tiie PARSE=ACL+6 in line 200. 
The colon and REM are already tokenized and tiius fill one byte each. 

There are a number of techniques for inserting assembly language code 
into memory from Applesoft, such as READ-DATA loops and so on. Here we'll 
use my favorite, the Lam technique, which has been discussed in Open- 
Apple a number of times (pages 12, 23, 77, 216). 

One problem, however, is that we don't know ahead of time the exact 
address w^ere the routine is to be placed, normally witii tiie Lam routine, 
you would put an RTS at $300, for example, with the Monitor command string 
"300:60". RaUier than messing around converting Applesofts decimal 
number to hexadecimal and inserting it at the beginning of the command 
string, lets POKE the address in bytes $40 and $41 (64-65), which is where 
the Monitor stores tiie "next changeable location." Then, rather tiian 
beginning the command stiing with an address, we simply start a colon, 
like tills: 

210 POKE G5,PfiR5E/25G : PDKE G4. PARSE- ( PEEK (G5)«25G J 

220 C$=^:fl5 88 48 flS B9 4B fl2 01 Cfi 86 88 Gfl m 02 84 

89 84 13 fl0 04 20 GC D5 S8 85 89 68 85 88 60" : E0SU8 500 

The rest of tiie Lam technique can be found in the listing at the end of this 
article at lines 500 tiirough 530. 

There are two tricks to writing assembly language routines that are to be 
stored inside Applesoft programs, First of course, tiie routine must l>e 
relocatable. It can't refer to any locations witiiin itself except vwtii relative 
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The system works 

I took a copy of your answer to my April letter (page 
2.23) to the technician at the local Computerland, 
The letter was about the trouble I've been having 
getting disi;s to boot since buying an Apple color 
monitor. 

When the technician checked my machine, he 
discovered that you were right' a shield was missing 
from my disk drive, and he replaced it All of the 
programs that would not boot properly before work 
well now. As an added bonus, ^e shield also solved 
some difficulties 1 have experienced in making 
copies of some disks. 

Thank you for your help. Even though most of the 
discussion in your pages is way over my he^ I will 
remain a lo^l sub^ber. 

Bemice Eaton 
norMdge, Calif. 

My subscription is up and six months ago I thought 
I wouldn't renew. Your paper is for the computer 



sophisticate. Your paper is too far above the layman. 
Then little by little 1 started getting a glimmer of what 
was gping on. I've been going over all the back issues, 
and I'm UMDERSTATlDiriQ them. Qee, what next? I can 
learn what has heretofore seemed esoteric Jargpn. 
Thanks. 

Many Charles 
nederland, Texas 

Understanding the Apple II requires neither superior 
intelligence nor a chip-like personality. Open^Apple 
really is dedicated to ' releasing the power to eve- 
ryone" It does take auMe to absorb enough of the 
lan^ia^e and o/ Que concepts to get staited, but 
thousands of perfediy normai peppfe fiaue learned 
enough to make ih^Af^ellsjump through hoops 
of fire. Remember— Qie more }pu resxi, the more 
you understand: the more you understand, the more 
you understand. 

Roots 

What is the nature of the mysterious ajq^mlix ft at 
appearsvAienyou UST the Integer Ba^:AfPLEV!SIOri 
program found on old DOS 5.3 system master disks? 

Where is the machine code with the dancing man 
and the little tune? 

Len lipschutz 
Jersey City, HJ. 

In the (Men Dayes, inhen / myself umpst an 
Apple // be^ei APPW/ISIOH was a maddening 
program. / wanted to write programs like tfiat one, 
but Apple's manuals had no dues whatsoever about 
how to proceed. 

now 1 know enough at least to tell you that you 
spoiled the fun by answering your own que^ion; the 
^'mysterious appendix " IS the machine code. My 
understanding is that it is fairly easy in Integer Basic 



to attach machine code routines to the end of 
programs, although I still don't know how to do it. 
Back in the days of cranky cassette tape, attaching 
the machine code to the program made loading and 
sailing agreat deal easier. 

If you're resJiy curious, the January 1984 issue of 
Apple User has an artide that s!wm how to cs^ure 
thehi-rescharadergenera^rbuMbiAPIWISIOIi 
for your own use. Appie User is published by 
DatabasePutUca^mslM., ^mpatiouse, 68 Qiester 
Road, Hazel Grove, StockpoH, SK7 5PfY, U.K. (061- 
480-0171). Annual subscription rates are 15 pounds 
in the U.K., 25 pounds in Europe, and 38 pounds 
elsewhere (airmaM), 

Double page 2 

Oh yes there IS page 2 double-high res! When 
SOSTOI^ is on, the FAQE2 Softswitch flips between 
main and auxiliary memoiy, just as you demonstrated 
last montti (page 2.40). However, when 80STORE is 
off (POKE 49152,0), the PAQE2 switch flips betfe^en 
double-high res pages 1 and 2. 1 got this from Roland 
Qustafasson, mMo's motto is "Dont beHeve everything 
you see in the manuals." 

David Eisler 
Littleton, Colo. 

Wfeii, to quote what I said last month, ''there is no 
more obscure arena in the Apple II world than 
double-resolution." My apolo^es to the author of 
Aloe's RQB manual who got it right after ail 

MacroWorks'muse 

I've been using MacroMyrks for several weeks. My 
lie mouse works fine when 1 am in the MacroVtorfcs 
program; however, it does nothing when 1 am in 
Appieltorks. The MacroWorks manual sa;ys nothing 



branch instructions. Second, things work best if you avoid having any zero 
bytes embedded within the code, for example, LDA #0 becomes A9 00 in 
actual machine code. If you embed this in a REM statement and then edit the 
program, the Applesoft editing genie will see that zero, assume it marks the 
end of a program line, change some next-line pointers around, and create 
the conditions for a certain SYHTAX ERROR the next time the program is run. 

notice the trick used in the fifth and sbcth lines of our PARSE routine to 
avoid a zero. 

If you can't avoid zero, all is not lost The Ihnitatton is that you must take 
great care to edit your pwrogram only v^en there are asterisks in the REM 
statement Don't attempt to e<Ut or save ttie program afl:er lUJllning it 

if you can avoid zeros, on the other hand you can actually SAVE the 
program with the assembly code embedded in the statement Before 
saving you can delete lines such as 210, 220 and 500 through 550. You can 
leave them out of your program from that point on. Hote that you will will still 
need a line like 200, however, to figure out where the routine has ended up. 

Here's a complete listing of this month's tridis: 
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» : Sar.MDOS DEMO 

* : 

» : by Ton Ueishaar 

* z July 1966 

* : 

* I a public domain progran 
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100 OEF FN PK(flORl=PtEKtflDH)+PEEK(flOR+lJ»2SG 

200 L=230 : Q0SU8 379^0 : mRSt=PICL+E : REM find line that ulil be modified 

210 POKE S5,PflRSE/2S6 : POKE G4, PARSE- ( PEEK (G5)»25G) 

220 CS:i*:a5 68 48 89 48 A2 01 BS 68 Cf4 R0 02 84 

B9 84 13 m 04 20 6C 05 £6 85 89 E8 85 88 60* : GQSUB 500 
230 :{;eii*«**********'^****************^ 



300 1=370 : G05UB 37990 : RDR=f^El't^4 : m find line that uUi be nodlfled 

310 INPUT -ENTER APPLESOFT CMO; CKD$ 

315 IF LEN(CI1D$)=0 THEN LIST 230: LIST 370 : END 

320 CftLL PflRSE 

325 ROOH»60 

330 FOR 1^0 TD fiOQM-l 

335 : V=PEEKt512+n : n=l 

340 : IF V=0 THEN I«ROOW : GOTO 350 

345 : POKE flDR+I,V 

350 NEXT 

355 IF V< >0 THEN PRINT TORMULfl TOO LONG- : PRINT : GOTO 310 
3G0 POKE flDR+11,58 : POKE flOR+Il+l,i7B : REH "iREM" 
3G5 DNERR GDTD 400 : REM syntax error trap 

380 POKE 21G,0 : PRINT : GOTO 310 : RE« elear onerr, resttrt 

400 IF PEEK(222) < > IG THEN PRINT 'ERROR r;PeEK(222}; 

- IN LINE ';PEEK(21B) + PEEK(219)»25G : END 
410 PRINT "THIS CUD HAS fl SVNTflX ERROR." 
420 CALL -3288 : GOTO 380 : REM see Jan B5, page 2 

500 CS»C$ + ' N 09066" : REM space required before and after N 

S10 FOR 1=1 TO LENICS) 

512 : POKE 5U+I, RSC(niD$(C$,M)]'^12e 

514 NEXT 

520 POKE 72,4 : CALL -144 
530 RETURN 

37990 REM * Find line number L « 

37991 REM « ACL=address of current line * 

37992 [CM » ANL=addrfiss of next ilm « 

37993 REM set ACL to start of program (TXTTAB) 

37994 fiCL=FN PK2(103) : REM address of current llnB 

37995 RNL=FN PK2(ACL] : REH address of next line 

3799G REN find line number L 

37997 IF L=FN PK2(flCL+2J THEN RETURN 

37998 V=FN PK2(flNL) r IF V>0 THEN flCL=ANL : flNL=sV : GOTO 37997 

37999 PRINT "There's no line "jL;" in this program." ; 5TDP 



aix)Ut the mouse support you d^aibed (June issue, 
page 233). How do I get itto work? 

Robert C. Moore* 
Laurel Md. 

Bessie Bros Im a free upgrade/or^ou 5end them 
the proof of purchase tab from the hack cover (^your 
manual and they'll send you a new disk and 
documentation. 

Rgffuly Brandt, MsumWoiim author, tells me the 
most creadve use of macros he's heard of so far was 
from a user who wrote macros to change his custom 
printer settings. These macros allowed him to work 
around the Appie]^rks limit of a single custom 
printer. The macros take 18 seconds to completely 
redefine the custom printer. 

SljpeiCafc 3a defended 

I'm curious to know the reasons behind your 
personal vendetta with SuperCaic 3a You've panned 
the program twice now (January 86, page 98; May 
1986, page 2.28). 

I can'tbelieve we're talking about the same program. 
SuperCafc 3a uses slash commands familiar to every 
user of VlsiCalc or its clones. It includes all the 
numeric functions AppleWoriw left out on-line context- 
sensitive help saeens, a superb graphing function, 
and built-in sideways printing. Plus its unprotected, 
automatically recognizes the extra memoiy on my 
RamUbrks and Apple memory cards, and runs from 
floppies, UniDisk 5.5, hard di^ or RANdisk. 

I suggest you take another look 

MarcS.Renner 

St Paul, Minn. 

/ think it's important to realize Tm cynical, grumpy, 
hot and Ured when I test new products. Consequently 
even I don't consider my opinion the last word on a 
product's quali^f or importance. I appreciate it when 
those of you who disagree with my Impressions ss^ 
so. 

My problems uMh the SuperCalc interface center 
on the wmiM use of the escape key when ' pointing" 
to oeKs uMr building formulas and the way the 
arrow and return keys wotk. Other than hauing 
reservations about the interface, however, i agree 
with you— as I said in May, the program is the most 
powerful Apple U spreadsheet I've used. Ill take 
another look at it next Ume I have some real numt)er 
enmeshing to do. 

LDA(83,Y)??? 

In the SU2.0BJ letter in your May issue (page 2.32), 
shouldn't the U)A (83,Y) instructions be LDA (83),Y? 

DickEllicott 
Baltimore, MD 

yes. And Utats how they appeared in Ruth's original 
letter, too. We'renowinve^atbighowthosedostng 
parentheses mana^ to move themselves to where 
they didn't belong. 

Whence come these pauses? 

One of my programs uses three nested FORWEXT 
loops to deal with a sequential text file. The loops 
cause the disk drive to start and stop several times 
when tiansfeningdata between the di^and memoiy. 
In some cases pauses last as long as five seconds. 

As I had not seen this happen before, I undertook a 
scientific investigation to determine the cause. Of 
course I realized that with my first loop 1 to 12, the 
second loop 1 to 9, and the third loop 1 to 10 that 



tiiere were a lot of loose strings running around in the 
system. Isn't it 12 * 9 * 10 (or something like that)? 

Rather than play around with that complicated 
program, I wrote a simple one to determine i^at the 
break point was for the disk drive to run continuously 
or to play stop and go. I aeated a file that consisted 
only of a list of numbers from 1 to 5000. 1 discovered 
that v^en X <= 88 the drive ran only once, but that 
when X=89 the drive would run, stop, then run again. 
Beginning at X=156 the drive would stop twice. At 
X=220 the drive stopped three times. The first 
incremental stop happened at 88, the second incre- 
mental stop 67 numbers later, and the third incre- 
mental stop 64 numbers afler that 

At this point it was obvious there was no riiyme or 
reason to the progresskm of stoppings, so I g^ve up. 
Why is my la^ He telling the disk drive to take a rest 
eveiy now and then while it chews on the data? Is my 
feiultless programming at &ult? 

Barney Woodruff 

Camp Springs, MD 

V/henyou mm a number to a textfUe, the text fUe 
actuary gets one character for each digit in the 
nsjiml)eK plus a carriage return at the end. So, for 1 
throu0i 9, you print two characters (a di0t and a 
carriage return) per number. FbrlO through 99, you 
print three characters (two dl0ts and a carriage 
return). 

There were 88 numbers un^n before the first 
driue access occurred. Thats 1 Uwough 9 (2 characters 
each), plus 10 through 88 ( 3 characters each), or a 
total of 255 characters. 

Then you printed 89 through 155. This is 11*5 (for 
89-99) plus56*4 (for 100-155) -257 characters. 

Then youprinted 156 through 219. This is 64*4 or 
256 characters. 

IVhen you print characters to a file, DOS ia/ces the 
characters and stores them in an area called a DOS 
buffer, which holds the same number of bytes as one 
^rage unit on the disk (256 for DOS 3.3, 512 for 
ProDOS). Only when the DOS buffer is full does DOS 
actually turn on the disk driue and store your 
numbers onyour disk. 

When you are reading from the disK the opp(^lte 
occurs DOS gets a buffeifull of digits from the disk, 
then feeds (hem one number at a tbne to yourlliPUT 
statements. 

The pauses occur because Applesofi can't process 
the bufferfuU of digits as fast as DOS can fill the 
buffer. So I>OS has to stop and wait while Applesoft 
works. This usually happens only with text files, 
because binary and Applesoft files are loaded into 
memory in mass. 

You'll find that some Applesoft programs and most 
assembly language programs can process a buffer 
full of bytes fast enough to keep the drive from 
turning off. With Applesoft, this would happen with 
programs that use longer strings and requbre fewer 
nUlTF or IHFUT statements to process a whole buffer. 

The reason the first two numbers you came up 
with don't match (255 characters versus 257) is that 
the three characters of 89 (two digits plus the 
carriage return) were split between the first tux) 
sectors written After your loop has PMfTed the 
numbers 1 though 88, 255 b}fies of DOS 3,5 
buffer have been fiUed. The 8 digit of 89 fills the 
256th and final bifie, so Unde DOS writes Uie buffer 
to the disk Appteso/t then starts filling the now- 
empty buffer with new data, starting with the 9 digit 
and the canriage return remaining from 89. This 
takes so long that Unde DOS gets tired of waiting 
and turns the ditue off . 



Thebytes in thefinalDOSbufferdon'tgetsamlon 
your disk until you issue a CLO^ command (under 
ProDOS, a FWSf! command also does this). This is 
why it is very important to always CLOSE files. 

Because your pauses occurred where they did, 
incidentally, we can tell you were using DOS 3.3. If 
you had been using ProDOS to run this test you 
would have encountered pauses only half as often, 
because a FroDOS buffer is twice the size of a DOS 
3.3 buffer. 

The slow DOS 3.3 garbage coUector may also be 
involved in the length of the pauses you experienced 
with your original program, for possible fixes, see 
the Opett'^ples for January 1985, pages 4-5; 
March 1585, pages 17-19; October 1985, page 76; 
and May 1986, pa^e 2.31-32 

Basiasystem tricks 

I knew you were tired of the same old ProDOS boot 
filename STARTUP, so I wrote this little routine to 
enable you to change it to any legal ProDOS filename 

of seven characters or less: 

10 D$=CHR$t4) : INPUT "NEW BQDT FILENAME: F$ 
15 IF LE:N(F$) > 7 THEM PRINT "TOO LONS* : GOTO 1» 

2e PRINT [»;*BLDflD BASIC.SYSTEM JSYS^flSaeW 

25 V=PEEK(8192) 

30 IF V=1G9 THEN f!=8G77 : REM yersion 1.0 
35 IF V=7G THEN fl=ai98 : REfl yersion 1.1 
40 IF fl=0 THEN PRINT "Version unrecognized" : END 

50 POKE ft, LEN(F$) 

55 FOR X=l TO LEN{FS) 

£0 : POKE A+X,ASC{niD$(F$,X,l)] 

65 NEXT 

70 PRINT OSrSSflVE 8fiSlC.SYSTEM,TSYS,ftf2000'' 
80 END 

Apple neglects to mention it in the manuals, but 
the ,T(ype) parameter can also be used with CAT and 
CATALOG to limit the display to files of a single type. 
For example, CAT TEAS lists only the Applesoft 
programs found in the active directory. Other file 
types are not listed. This is helpful when looking for a 
particular file on a crowded disk. 

Joseph Kline 
APO Mew York 

CATALOG, Tpublicdomain 

1 am working on a descriptive catalog of some 
public domain software I obtained at the north 
Carolina Educational Computing Conference. I am 
wondering if any of your readers have ever compiled 
or would be interested in such a catalog. I am hoping 
for some advice about format and detail as wet! as 
some input as to possible interest I find it veiy 
flrusti^fii^ to pi<* over this software to find the good 
and throw out the bad and duplicate. Is some moral 
support or feedback possible? 

Janice K£^0 Donovan 
Oak Ridge, nc. 

The task of writing descriptive catalogs for public 
donmn software has nearly killed many a good 
person. WhUe there are a few reaHJewels in the public 
domain, you have to ^ft throi^ tons of semi- 
predkius and not-so-predbus rocfcs to find them. Ws 
the ^ftlng that tends to Idit people. 

/ myself would find a list of the "best of the puWic 
doma^" interestfrig. / think lots of people would. 

Here are two descriptive catalogs you might want 
to look at to see how other people do it These two 
list both Jewels and mundane stones, but seem to 
have washed away at l&^ some of 0^ mud. 
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ilppte Software for Pennies, by Bertram Gader 
and Mamei V. Fiodar, costs $9,95 plus $1 shipping 
from Warner Books, FOBox 690, hew YorK MYmiB, 
It lists hundreds of public domain programs for the 
Apple U in the following categories; games, demon- 
stratk}nsand3ffi music and sound, uMies, education, 
business and home, and commum'cafions. It also 
has a long list of Apple User Groups and complete 
details on how to order public domain software from 
about a dozen of these groups, A highlight of the 
book is an ll-page instruction manual for the public 
domain EAMOU adventure games. 

The second descry)tlve catalog of public domain 
softoare that Ive heard of Is auailaMe from the Btg 
Red Apple Qub, 1105 S 13tK #103, riorfolk, HE 
68701 Big Red was started for people who don't 
have ready access to a (oca( user's group. Dues are 
$12 a yeai for which you get a monthly newsletter 
that describes new software added to the library. 
Public domain disks are sold to members for $2.50, 

Compilingyourownpublicdomaincatalogshould 
be treated Just like a rns^or programming projed— 
begin by dividing the task into small pieces and 
attack the pieces one at a time. Otherwise the work 
will swallow you whole and youH never be heard 
from again. It's awful to lose sut)scrit)ers that way. 

Mouse trace 

I have recently conflrmed that a mouse cannot be 
used successfully as a tracing device. heUs get the 
vw)rd out on this before others waste energy trying. In 
my first attempt, I clamped the mouse to a drafting 
board, glued toothpicks to it and meticulously 
traced over a street map of Boston. 

My primitive tracing device has lately shown up in 
various forms, including the $50 "MAOMakeAnottier 
Qjop/' advertised in various Apple mag^zines by 
Innovative Products of Oakbrook, IL The MA.C. 
promises a bonus; the ability to enlarge or shrink the 
traced artwork via a pantograph mechanism that 
clamps onto ttie mouse. 

Using the MAC. requires practice, patience, and a 
desk the size of pool table. I spent three days aeating 
this trace of a photograph of you from an old SoftaUc 
PleaseM me loiowwhen thefhunderscan is available 
for the Apple fi. 

BradVi^lters 

Boston, Mass. 

P.S. I would have returned the MAC. within 10 days for 
my money-back guarantee, but it took me three 

weeks just to assemble the dam thing. 
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Bade when Apple first introduced the mouse I 
came up with an idea for a program to be called 
PBtpenooik (no, not "\ooff^). The core of my idea 
was that word processors had made the ^pewriter 
obsolete in att areas but one — filling out forms. It Is 
nearly impossible to fill out a form with a word 
processor— something that was quite easy to do 
with a typewriter. I was convinced (and still am) that 
the world needed a good soluUon to the fUling-out- 
forms wUh a computer problem. One of the resdly 



odd consequences of the con^uter revolution is that 
more form are fUled out by hand nota than ten years 
ago. 

My plan was to haoe people identify the upper-left 
comer of a form and the relative po^ons of its ceils 
by mcMngthe mouse around the form, A few mouse 
movements would, in theory, recreate an image of 
the form on the screen and In the compulefs memory. 
The idea crashed when J found, as you have, that the 
mouse is totally incompetent as a measuring device. 

I recently ran across another solution to the blank 
form problem on AppleWorks User Group disk ^28 
(seepage2.35h however. RobertMenillofCai^fMei^ 
CA created a grid unth the AppleWorks word processor 
that can be prvnted on a spare copy of the form you 
want to fUl out The grid shows you the line and 
wlumn numbers of the cells on the form. Using the 
line and column informatton thalApple^^rks displays 
at the bottom of the word processor screen, you can 
easi7y move the cursor to a cells exactpage position. 
Another possibility is to print the grid on a sheet of 
dear plasUc and lay Hover the form— this technique 
works even if you hm only one copy of the form. 
Merrill suggests that you print out your file on a 
blank sheet of paper to make sure everything is 
going where you expected before you aaually print 
on your form. 

Hex calculators 

Open-Apple readers may be interested in a new 
Casio calculator (Model CM400). It features binary, 
octal, hexadecimal, and decimal conversions, arith- 
metic and logical shifting, left and right rotation, MOT, 
ATiD, on EOR, and handles numbers up to 32 bits. 1 
got one for under $20, which I believe is around list 
price. 

Michael Qruenthal 
Durham, N.C 

Thanks for this tip. I've been using a hexadecimal 
calculator for several years-- 1 can't imagine douig 
much in assend^y language uMhout one. 

Examining high memory 

April's discussion of RAM cards has renewed my 
interest in how to use the 16K RAM card in my Apple 
II-Plus, 

The card was purchased some time ago and I know 
that the hardware is okay because Integer Basic 
loads and runs, and programs such as VisiCalc find 
and use the extra memory. 

Thanks to your discussion, I now understand why 
Applesoft will never use the additional space, but I 
don't understand vAt^ I can't seem to get at this 
memory with the Monitor. When I try to set a value at 
any address in the upper 16K space, then list it back, I 
find that I have accomplished nothing. 

1 also have your ProntoDOS and have tried using 
the subroutine at $BEAF to turn the card on after 
running DOS-UP. The result is that the md still won't 
accept inputs. 

lassumethatlam nottumingthecardon properly. 
Can you tell me how to turn the card on from DOS 
3.3? I would like to store binary data and also small 
assembly language programs there. If these assembly 
language programs cannot be called directly from 
Applesoft, they should be able to be linked by a 
routine within the 48K range v^ich would, in turn, call 
tiie program on the language card. 

Any help or hints you can provide would be much 

TerdQ. Fender 
Qlenvieu^IU. 



Begin by remembering that the Apple can only 
"see" 64K of memory at any one instant and that 
your Apple U-Plus had that much before you bought 
the 16K RAM card. The memory in your 16l{ card 
shares the same address range ($D0OO'$r!Tr) as the 



Here is achsatofthesoftswltches usedfortuming 
on and off this memory area which Appie likes to 
call ''bank-switched memory" and otd-timers Ufcc to 
call language-card memory ": 

Softswitchis for Rpple II languagi card fasinory 



— $D0M to «OFFF— 
BRNK 2 dm 1 

Write-protect card 

read laGtherboard R SC082 R SC^Sfl 

read card R %Cm R $C088 

Wri£»-Bmlilf card 

read matherbmrd St9Bl RR SC069 

read card RR SC063 RR $C96B 

Status (Ile/lIc only) 

high bit oF $0011 l=banl< 2 0=bank 1 

high bit of $C012 l=read card 0=rBad mbd 

R=Read once RR^rsad tuice 

TTie bank 1-bank 2 stuff refers to the fact that the 
addresses from $D00O to $rrFF are really only big 
enoughformofEAM,Tofitinawholel6Kthearea 
from $D(M) to $Df ff is used tidce. Bank 2, by 
tradltloa is the pttmary bank. The bardc l-bank 2 
setitng doesn't affect what you see in the area from 
$EO00 to $FFFF neither does it have an effect on 
what you see when the motherboard is turned on (ie, 
the switches at $C080 and $C088 do the same 
thing). 

The R and RR stuff refers to the fad that the 
switches should be read, not written to, and that 
wr1te-enat)(ing the RAM card requires two reads of 
the respective suMdi not just one. 

The statm stuff refers to two bytes you can read to 
determine the current setting of the "card" on lies 
and lies, Yourll-Flus doesn't have these switches. 

Rather than try to remember all the numbers in the 
chart, concentrate on the two in the middle of the left 
column. Peeking at $C081 twice in a row lets you 
write to the WKcard while reading the motherboard, 
$C083 is the same but lets you read the card as weU 
aswritetoit 

TTie difficult part of using the memory on the 16K 
card is that whenever you turn it on, Applesoft and 
the Monitor disappear. Consequently, you cannot 
examine the memory in the 16l{ card with the 
Monitor unless you move an extra copy of the 
Monitor onto the card. 

This, however, isn't hard. Loading Integer Basic is 
one easy way to get a copy of the Monitor in the card. 
AnoUier is with the follou^g series of Monitor 
commands: 

cm N ceei n Fee0<Fe00.FFrrH cm n c0B3 

The $G)31s fbcUso youare rea^ng from the 
motherboard but writing to the card. The 
F80O(F800.FFFFM moves a copy of the Monitor from 
$F800to$F800, thusgivingusaMonitortousewhlle 
the RAM card is turned on. Finally, the $C083s turn 
the card on con^)ietely. 

Horn to prove to yourself that this worked, poke a 
t)unch of 35s at $0)00 and then examine memory to 
see if they stuck: 

E000.E00? 

E000- 00 FF FF FF 00 00 00 90 
£000:55 55 55 55 55 55 55 55 
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m<b- 55 55 55 55 55 55 55 55 

They did, so this must be RAM. 

7b use this JW1 effectively, you must approach it 
from assembly language. Again, you absolutely 
cannot get at the card from Applesoft, because when 
you turn the card on Applesoft disappears and your 
program crashes. Your idea of linking the routines on 
the card to Applesoft by means of other rouUnes in 
the lower 4SK shows you have a basic understanding 
of this. 

Assembly language programs will run just fme on 
the card, but they can't call Applesoft routines. They 
can't use Monitor routines, either, unless you move a 
copy of the Monitor over to the card. 

The DOS-UP hook at $BEAF does in fact turn on the 
card (bank 2) for both reading and writing. You can't 
use this hook from the Monitor, however. E^ry time 
you type a character, DOS-UPhas to turn the language 
card on twice— once so DOS can examine the char- 
acter as you type it and once so DOS can examine 
the character as the Monitor prints it to the screen. 
Just typing BEAPG and return causes $BEAf^ to be 
caiied (and the card to go on and off) twelve times. 
The routine at $BEAF will dutifully turn it on a 
thirteenth time for you, causing the Monitor to 
disappear. The RTS at the end of $5EAF that shoidd 
return you to the Monitor sends you scurrying 
through DOS instead. Usually youll hit a break 
before your disk drive goes up in flames, but that 
isn't guaranteed. $BEAP is sold as-is; it is useful only 
from assembly language. 

PRffSandProDOS 

In plain, easy to read assembly code, how does one 
properly activate the 80-column card v^en using 
FroDOS on a He (i.e., without using a form of FRinX 
CHR$(4);"FR#3". but by direct manipulation). 

William M. Reed 
new Orleans, La. 

It all depends. Are you writing an assembly lan- 
guage program that will be in a binary file and co- 
exist with Basicsystem, or are you writing one that 
will be in a system file and will manipulate the 
ProDOS kernel's machine language interface? 

It's a critical difference. If you're writing a system 
program, you have to handle and keep track of all 
peripheral connections— screen, printer, and so on 
—yourself All the ProDOS kernel was designed to 
help you with is mass storage (disk) devices. 

In this case, in pure, unadulterated machine 
language, the answer is to do just a touch more than 
the obvious; 

PiS 93 LOft aS99 get a harmless ASCII chr 
20 00 C3 JSR $C300 cold start the card 

This assumes that you have checked to make sure 
there's a card to jump to first— use the ProDOS 
MACniD byte at $Bm;bit 1 (76545210) wUibe "l"i/ 
ProDOS recognized an 80-column card during the 
boot process. It's also very important that you put 
something harmless in the A register before calling 
$C500-'$99 is a control-Y, the code for homing the 
cursor without clearing the screen. Dennis spent a 
whole afternoon once just figuring out that he was 
trying to initialize the card with a leftover $15 in the A 
renter. This is control-U, the code for deadivaUng 
the 80-coiumn firmware; you definitely can't turn on 
SO<olumns by printing that character. 



Mow, on the oUierhand, if your assembly language 
program runs under Basicsystem, there are two 
ways to go. One is to simply poke $C500 into 
VECroUT (vector out) in the Basicsytem global page 
at $BE50 and then print something, like this: 

ng 00 LDfl ti0 

8D 30 BE STfl VECTOUT poke $BE30,$C300 

R9 C3 LDfl tt$C3 

8D 31 BE STfl VECTOUT+1 

flg 99 LDfl 8$9g get a control-Y 

20 ED FD JSR CDUT print it yia $FDED 

The other way to go is to poke the ASCII string 
PR^5, followed by a return, into the keyboard input 
buffer at $200, and then call DOSCMD in the 
Basicsystem global page at $BE03, According to 
Apple's ProDOS Technical Mote #Z this trick works 
for all Basicsystem commands except dash, RUM, 
LOAD, CtlAIM, READ, WRITE, APPEMD, and EXEC (the 
main ones you wanted to use, right?). 

The common technique under DOS 5.3 of printing 
command strings such as \ontrol-D PR#3" directly 
from assembly language doesn't work under 
Basicsystem, 

If you use the keyboard input buffer-DOSCMD 
technique, you should check the carry for an error 
when Basicsystem returns to you. If an error has 
occurred, you can do one of three things, A JSR 
ERROUr ($BE09) will send control to your Applesoft 
OMm routine. A JSR PRIMTERR ($BEOC) will pmt a 
suitable error-message on the screen and return to 
you. The Mrd possibility is to handle the error 
yourself completely. In this case, make sure you 
clear the carry before RTSing back to Applesoft 

Echo overwrites program 

1 am usin^ a He with Extended 80-Column Card and 
Epson MX-80 printer. The printer is connected through 
a Dumpling OX in slot L 

Occasionally, when using conditional branching 
(mainly IF... THEN), I get an UriDEfD STATEMEIiT 
ERROR and my program listing is garbled. 

After trial and error 1 have found the program will 
run normally when I change the printer interface card 
to a Frometheus FKT-l All switches on the Dumpling 
OX are set as recommended for my printer. Can you 
suggest a solution so that 1 can use the Dumpling 
OX? 

Gene Watson 
Sulphur Springs, TX 

/fere's a wild guess. I suspect the Dumpling 
firmware that echos printer characters on your 
display screen expects you to use 40-column mode. 
If you print with the echo in 80-column mode, subtle 
bugs nmy cause the echoed characters to miss the 
screen and overwrite the beginning of your program 
instead. 

There are two solutions. One is to turn off 80- 
column mode before you try to print This is Apple's 
recommended solution to the problem (see "Errata 
to the Apple II 80-Column Text Card Manual" page 4), 
Obviously programs such as AppleWorks and Apple 
Vliter don't follow Apple's advice in this matter, 
however, so why should you? 

The other solution is to use the proper control 
codes to tell the Dumpling not to echo printed 
characters to the screen. I don't have the Dumpling 
control codes handy, but for most cards the command 
sequence is something like '^control-I 80M". The 
eighty tells the card how often to add carriage 
returns— if your card has a code for "never" (zero on 
many cards), it's usually your best choice. For more. 



see our Movember issue, pages 84 through 86. 

A final possiblity is that the manufacturer of the 
Dumpling can provide you with updated ROMs for 
the card that will solve the problem. Giving the 
company a call can't hurt 

Hard drives and Apple Wter 

Do you know how to put AppleWriter lie on the 
Sider hard disk system? 

LouisA-Marinaccio 
Bel Air, Md. 

Good old DOS 3.3-t)a5ed ^pleWdter He uses a 
customized version of DOS and is copy protected. 
Consequently, it is difficult to use from a Sider or 
RAMdisk. 

However, there is a secret provision ujithin Apple 
Writer lie that allows it to work with a Corvus hard 
drive, but only if the hard drive is in slot 6 and the 
floppy in slot 7 (backwards from most ^der installa- 
lions). Press "C" while the Apple Writer lie disk is 
booting and a prompt will appear asking if you want 
to enable the Corvus. Paul Lutus, Apple Writer's 
author, reueaied this tidbit in a letter to Byte (August 
1985, page 52). Lutus seems to like this sort of 
undocumented feature; a serial interface driver for 
the game connector was secreted within the original 
version of Apple Writer. 

The newer ProDOS version of ^ple Writer is 
unprotected and can simply be copied to a ProDOS 
volume on any RAM or hard disk. To get it up and 
running, you must first set the prefvc to the subdirec- 
tory the program is in, then execute AW.SYSTEM. If 
you are using a RAMdisk that appears to be in slot 
three, however, Apple WHter will disconnect it The 
slmpUest way to avoid this is to move the RAMdisk 
slot assignment somewhere else. If you are using an 
awdliary-slot RAMdisk, you'll also need to make sure 
the RAMdisk driver doesn't try to use the awdliary 
64K memory bank, because Apple Writer aiso uses 
it. 

fVontoDOS on the Sider 

How can I get ProntoDOS onto the Sider? In 
particular, 1 would like to speed up floppy disk access, 
get the free sector list at the top of the catalog, and 
make sure that a disk initialization doesn't leave a 
copy of DOS or a HEUX) program on a floppy 

David Holladay 
Madison, tt^sc. 

TTiere are two primary ways to go about using 
FrontoDOS and the Sider. One is to actually put 
ProntoDOS on the Sider's boot track, so that it 
comes up when you turn on the system. The other is 
to leave DOS 5.5 on the boot track, but modify it into 
ProntoDOS after the system is started. 

To get ProntoDOS on the Sider's boot track, begin 
by booting the FrontoDOS disk, then use the 
program PROmO UPDATE to make the DOS enhance- 
ments you want (such as the free-sector and initiali- 
zation items you mention). You should now have an 
image of DOS in memory that is the one you want to 
come up when the Sider boots. 

Mow insert the Sider DOS 5.5 uUlities disk and RUM 
MAtiE BOOT TRACK. The manual says the MAm 
BOOT TRACK program is to be used when you move 
the Sider controller card from one slot to another, 
however, it can also be used to simply place an 
image of the DOS in memory onto the Sider, Don't be 
surprised, however, when it asks you which slotyou 
intend to move the controller card to: just answer 
with the slot numtier it is already in. 
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YoucanskipMAKEBOarTRACliifyouhaDenotyet 
tniMized your ^der. Insert the ^der irtstaUation 
disk and KWY HEUjO (do not boot the disk) after 
booWng and enhancing ProntoDOS. During the 
InH^bH&iion process the image of PmioDOS in 
memory wiU be piaced on the disk. 

If you have some DOS 5,3 programs that don't 
work uM AontoOOS and would prefer to have 
iAi^n DOS 5*5 on Om Sftfer, sXtmMie fs to 
mme the program fiELLO M)im)'DOS from the 
FmnMOS cN^ otOo die &der smirunt afier 
booting the Sfcfer, lOmemuaiimA the DOS in 
memory changed MoPlmMOS. 

Vie two disadoants^es of this tecfmigue are that 
there's no way to install the enhancements you want 
andsomeUmesitdoesn'tseem towork. TheDOS5.3 
image on one version of ttie Sider installation 
utilities (distributed between aboia Odober 1985 
and March 1966) accidentally had three mixed-up 
bytes in one of the areas tiELLO PROnTO-DOS uses 
to identify DOS. If your Sider boots with this DOS 
image. nmX) PKOmO-DOS will tell you it doesn't 
recognlie the DOS in memory and will refuse to 
©BECtitc. The solution is to use MAKE BOOTTRAOito 
put a dean copy of DOS 3.3 onto yowf Sider. 

Incidentally, ProntoDOS speeds up not only 
fi(^^ disfcsi, but hard disks and RAMdi^ as well 
See F^bnmu 1385, page M pr the ImstedtiAe 
d^tjd&s. 
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More Sider secrets 

After several more Sider oashes ahiiDlar tD llie 
disaster discussed in August (page 63) and October 
1985 (page 79), I finally have an miswer to fhe 'liard 
cfisk life" I Ve beon exp^endng. 

Aftor each new crash I would be fenced out of 
additional areas of (he hard disk, losing files each 
time. I would have to reinitialize the Sider to put 
things right The aashes occurred during disk accesses 
and it appears that my original association of the 
CTash with pushing reset while yuppie Writer was 
printing was just coincidental. Each time 1 reinitialized 
the Sider there was no indication of a problem. 

The brealithrough came when I began to work with 
a new 20 meg Sider that 1 daisy-chained to the first as 
/HARD5 and /HARD4. The new utilities package that 
came with the 20 meg unit included Apple's ProDOS 
BACKUP program, BACKUP would crash when aeating 
the /HARDl catalog for the backup disks. After each 
aash I would have to cold start to regain control of 
tiie Ai^e. The crashes wermt BACKUPS feu^ but 
resuMed fifom the program attemplkig to amss 
evexy file on MARDl When BACKUP bepn id do 
bmbiess witti a poisoned sedkm of the disk, fhe 
Sider wouM enter hyperspaoe m& BACKUP would be 
Changing. 

The next time I reinitialized the Sider 1 got a "non- 
media error 95" during final verification. TTiis was the 
first time I had seen this message. The Sidor would 
apparently function normally after reinitialization 
until a file happened to hit on the track with the 
problem. Once this track was accessed the whole 
process of ^dual bad-blocking of more and more of 
die Sider would begin anew, 

1 called the Sider hotiine to find out what a "non- 
media enror 95 ' was. The veiy-helpful technician 1 
talked with was not sure of the significance of tiiis 
message, but suggested that it probably indicated a 
marginal track. He suggested tiiat 1 use some undoc- 
umented features of inSTAa VTH (on the DOS 53 
utilities disk) to run a system check. 

To access fli ese utilttles, BRUIi IMSIALL FT#4, fiien 
hitfheRkey%idthinoneortMDseGonds.Thisresidtsin 
a menudtoi package of mandous madAneiy I 
dont know why they keep these utilities a seaet— 
there are some really usdul tools fai this program — 
perhaps because there is plenty ofpotential to wreak 
havoc on your disk if these tools are misused. Among 
other processes, you can run a non-destaiictne check 
ofall tracks— apparently this isthe same routine that 
writes dots to the saeen as It verifies the disk afNar 
initialization. 

This check gave me a "non-media error 95" again. 
An option during tiiis check is to reassign one of a 
couple of dozen spare tracks to replace any marginal 
track. This option carries the obvious caveat that 
reassignment may destroy data on die disk. I was 
able to reassign the offending track, 03313, without a 
loss of data. Apparentiy 1 had not written to ttiis track 
since last reinitializing the disk. Ny old Sider has 
performed flawlessly shioelhereplaoement I suspect 
that this tr^ had been marginal since I first b^n 
to use the disk. 

It looks as if any time the Sider is not able to 
complete a dl^ function because of a fial^ tack it 
can lose all s^ise of respon»bilily and vkknisly tear 
away at previous^ uncaomipted files-at least ttiat 
was my experience. 

Some of m utiUti^ Mden on WSIML Pr#4 
include provision fior reformatting Just Ihe DOS 3.3 
portton of the disk wtttKiuttoudilng areas attotted to 



other operating systems. Also included is a provision 
for zeroing the catalogs for just the ProDOS portion, 
leaving Uie otiier sections alone. 

Apple's BACKUP program is great It wori« so well 
tiiat backing up tiie entire disk is a piece of cake. 
According the tech 1 spoke with a new backup utility 
for tiie Sidefs DOS 3.3 section, which will work 
similarly, will be available soon. Thel|' present DOS 
3.3 utility is a loser because it prompts you for each 
file. You have to st^ alert during tiie entire backup 
procedure and itspahiAdly^The ProDOS BACKUP 
program does almost eveiytifiing for you but put the 
flopi^ in the drive and it wont let you make a 
mistake. 

The new iitillttes supplied wtth Ihe Sder seem to 
place mcHeempliflisimparidnglhelieadsbdDre 

turning the unit off. I asked Ihe tech about this, since 
tiiey had told me earlier tiiat parking tiie heads was 
on^ important before moving tiie unit around. His 
response was tiiat there had been some kind of 
problem related to tiie Apple writing to tiie hard disk 
when it wasn't up to speed if tiie heads were positioned 
over prime real estate on the disk. It seems that 
parking the heads is more of a precaution apinst 
this eventuality than against a head crash. 

Do you have any more information on tiie upgrade 
for Apple H/Hter2.0you wrote about in Januaiy (page 
97)? The dealer where I bought my original doesn't 
now anyttiing about an upgrade and if there are any 
improvements I'd sure like to have them if they 
aren't significant 

Donald Bealy 

San Mateo, Calif 

TTianics for all the Sider secrets. As of the end of 
March, when Dennis last talked a list of avaMable 
updates out of Apple's district sales office here in 
"CE^tomers having printing problems wth Appie 
HHter 2.0 and third-party interface cards may take 
the disk to the seller who will correct the fault 
Omiugh an update utility:' This is what you're 
tooktigfoi^ tut Appie has nemclaiifled what 
aie siwosetf to <lo uiiieR file ifeater dbes^ 
utfiathe'ssE^pposetftohane. 

O^rApi^ U upds^on Ihe are.- 

f^la lie enharxranant 
m from dealer (InsUlled). Stlf-lnatallation 
recoomnded so you can keep youf old chlpa. 

ftppieltorks 1.3 

$20, get mailer from dealer 
ProDOS 1.1.1 

Free update frorn dealer 
SuperPilot Log 

Free update from Rpple Customer Relations MS 27-F 
Pascal Version 1.3 
$125 + original fWPLEl disk (no personal checks) 
Apple CfMputar Pascal 1.3 Upgrada 
P.O. Boot m 
Half Hoan Bay. CA 94919 
Logo 64K 

Oiaks that don't york on lie tMcauaa of spiral 
protection tehenw can ba raplacacf through 
Fipple's Media Exchange Prograa. Upgrade to 
Logo II [12eK) not aval labia. 

ProOOS Users Disk 

If MouseText characters appear, disk ba 
replaced through Apple's Madia Exchange 
Program - 

Ap^'s Media Exchange Progmm, inddenMly, 
itporis Site this. Vjioufiaoe adamsge^ 
mameiymsetan^MmngiPir^pm 
jfourdeater. PSIttoutamfseRdft to4pplealof|0wftfi 
the damaged dfsfc or mamial 4pjpfe tiiCB send 1^ a 
ic^pjacement at no cost 3 to 4 ineefcs. 



